pp108 : Service Container Configuration Interface

Service Container Configuration Interface

This topic describes the service container configuration interface.

General Tab

Fields

Description

Name

Name of the service container.

Computer Name

Name of the computer on which the service container is running or on which it has to be created.

Assign OS Process

Enables the new service container run in the existing JVM. When this option is selected, the Select OS Process list is populated with the names of the existing OS processes. Note: If any of the application connectors selected in the first step cannot share a JVM, this option is disabled.

CAUTION: If you are configuring a WS-AppServer Service, ensure that you do not configure more than one WS-AppServer Service to a single OS Process. Doing so will result in configuration errors.

Startup Type

This denotes if the service container must be started automatically or manually, when the OpenText Process Suite Platform (<instance name>) has started and when the service container stops. Note: The Number of Attempts for Auto Start group box is enabled only when the startup type is Automatic.

Number of Attempts for Auto Start

Determines the number of times the service container must be restarted if it crashes. The options are as follows:

  • Default - OpenText Process Suite Platform (<instance name>) automatically starts a service container for three times. This includes the first time it starts and two subsequent stoppages.
  • Infinite - The service container is restarted automatically whenever it crashes.
  • Custom - In the text box, you can type the number of times you want the OpenText Process Suite Platform (<instance name>) to automatically restart the service container.

Request Notification Timeout

The time period (in milliseconds) that the service container has to wait for the response.

Preference

The order of preference of the service container under the Service Group to which it belongs.
Note: This field is displayed only when Simple Failover is chosen as the routing algorithm while configuring the Service Group.

Use Default Log Settings

You can choose to continue with the default log settings. To set the logging options, clear the the selection of this check box and configure the logger settings in the Log Settings tab that appears. For more information on this tab, refer to Log Settings table shown below.

JRE Configuration Tab

Note: The JVM settings of the Monitor service container are read-only as they are obtained from the wcp.properties file directly. Therefore, to modify the values of the JVM, you must make the relevant changes in the wcp.properties file.

Fields

Description

Classpath

Specify the additional directories or jar files for the service container classpath to start the service container successfully. These entries must be separated by the OS-specific classpath delimiters.
Note: Runtime classpath for a service container will be <classpath specified in the JRE Configuration tab> + <classpath specified in application connectors configured for this service container> + <classpath specifed in SYSTEM environment variable>

Set the Parameters

Click to add the JVM Options, which will be executed when the service container is started. An invalid property may stop the service container. You can delete the JVM options by selecting their corresponding check box and clicking . The JVM properties defined here with -D take precedence over properties defined in the wcp.properties file available in the <Process_Platform_Installation_Directory>/config folder.

Policy file name This specifies the name of the security policy file (with location path), which contains the permissions that are granted. The file has the .policy extension.

Log Settings Tab

Fields

Description

Enable Logging

This option allows you to enable the log categories and severities.

Use System Policy

This option disables all the log categories and severities, because the system-level configuration is applied. On selecting this option, the Log4jConfiguration.xml file in the <Process_Platform_Installation_Directory> is applied to a particular service container.
Note: By default, the Enable System Policy check box is selected and other fields on the page are unavailable. To specify Logger Severities and Logger Consumers details, clear the Enable System Policy check box.

Logger Severities

  • Root Severity - Turns the log option on for all the severity levels, including those that are not listed on the screen. The severity levels selected here would apply to all the categories. Tip: Enabling the lowest severity level automatically enables the remaining severity levels. However, enabling or selecting the highest severity level enables only that severity.
  • Category-wise Severities - Sets the severity for a specific category. If the Root Severity is selected, then automatically it turns the Category-wise Severities option on for all the categories.

Logger Consumers
Note: This option is enabled only when the Enable System Policy option is not selected.


Process Platform supports various kinds of log consumers, including those from Log4j for consuming log messages. One or more consumers can be selected for publishing messages. The appropriate log consumer must be selected during the Service configuration. The following are the available options.

  • Publish to File - The log messages are written to the file specified during log configuration. The default path for this file is Process Platform Installation Directory\Logs\<filename>.xml. In the absence of any file name specification, log messages are published to the console.
    Note: Use a double-slash for folder path specification, for example, <Drive>:folder1testlog.txt.
    • Do not roll - Select this option if you do not want to roll a file.
    • Roll File every- Rolls over files based on the user defined time intervals, which can be monthly, weekly, daily, hourly, and even for every minute.
    • Roll File for every- Writes the logs to file. When the log file exceeds a specified file size, it is rolled over with a filename.n. Here, 'n' is the number of times the file has exceeded the specified size.
  • Publish to Remote Host - Publishes the log messages to the specified remote host. You must specify the Host Name and Port Number.
  • Publish to OS-based event log - Publishes log messages to either the Windows Event Log for Windows OS or Syslog with facility LOCAL7 for Linux OS.